home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / misc / math / ReadWorkSheet.readme < prev   
Encoding:
Text File  |  1998-05-05  |  4.0 KB  |  100 lines
  1. Short:    V2.1, Read/execute non-Amiga MapleV worksheets
  2. Author:   tboeckel@uni-paderborn.de (Thore Boeckelmann)
  3. Uploader: tboeckel@uni-paderborn.de (Thore Boeckelmann)
  4. Type:     misc/math
  5.  
  6. ReadWorkSheet.rexx is an ARexx script to read and execute MapleV worksheets from
  7. non-Amiga platforms. Below is the man page for ReadWorkSheet.rexx.
  8.  
  9.  
  10. FORMAT
  11.      ReadWorkSheet [Filename | ?] [TRACE] [TOKENTRACE] [PARSETRACE]
  12.                                   [LIST] [NOMAPLE] [ASYNC]
  13.  
  14. TEMPLATE
  15.      Filename,TRACE/S,TOKENTRACE/S,PARSETRACE/S,LIST/S,NOMAPLE/S,ASYNC/S
  16.  
  17. PURPOSE
  18.      Allow Amiga MapleV R3 to read worksheets produced by other MapleV  versions
  19.      and platforms
  20.  
  21. SPECIFICATION
  22.      ReadWorkSheet.rexx is an ARexx script to read and execute MapleV  worksheet
  23.      produced  by any platform or MapleV version. Text regions and input regions
  24.      will be passed to the Amiga MapleV engine to be processed.
  25.  
  26.      The filename can be replaced with ? to obtain this help output.
  27.  
  28.      The TRACE keyword causes an ARexx 'Trace Results' to be issued and is meant
  29.      for debugging ReadWorkSheet itself.
  30.  
  31.      TOKENTRACE will display each and every token from the worksheet  as  it  is
  32.      read. Also used for debugging or checking out the syntax of a new worksheet
  33.      format.
  34.  
  35.      PARSETRACE traces the  entry  and  exit  of  all  parse  subroutines,  with
  36.      indentation.  Various  significant  data  from  the  worksheet will also be
  37.      displayed.
  38.  
  39.      LIST will list the contents of the entire worksheet to  STDOUT,  as  it  is
  40.      parsed.
  41.  
  42.      NOMAPLE will parse only, and can be used without starting up MapleV first.
  43.  
  44.      ASYNC will  allow  the  parse  to  continue  asynchronously  with  MapleV's
  45.      execution.  Otherwise,  the  parse will wait for MapleV to stop calculating
  46.      before sending it any input string that requires computation.
  47.  
  48.  
  49. IMPLEMENTATION
  50.      ReadWorkSheet.rexx uses recursive  descent  parsing  to  parse  the  MapleV
  51.      worksheet.  The  syntax  of  a  MapleV Worksheet is described in psuedo-BNF
  52.      format in comments within  the  program.  There  are  also  several  useful
  53.      subroutines   for   parsing   (GetChar,  UnGetChar,  GetToken,  UnGetToken,
  54.      ParseTrace, ParseTraceEntry, ParseTraceExit, and TokenTrace.
  55.  
  56.      Unfortunately, ReadWorkSheet.rexx can run very slowly, as it must skip over
  57.      all  of  the  worksheet  text  that  represents graphics data, typeset math
  58.      expressions, or MapleV output.
  59.  
  60.      The syntax of MapleV worksheets  was  derived  by  careful  examination  of
  61.      numerous MapleV worksheets, many of which were obtained from the Net.
  62.  
  63.      This program was motivated by the fact that Amiga MapleV on my machine,  in
  64.      my environment, gurus when fed a non-Amiga MapleV worksheet.
  65.  
  66.      If you encounter a valid MapleV worksheet that causes ReadWorkSheet.rexx to
  67.      report  a  syntax error, please lha it, uuencode that, and email the result
  68.      to me at: tboeckel@uni-paderborn.de
  69.  
  70.      I also welcome any other comments, bug reports, or suggestions.
  71.  
  72.  
  73. AUTHOR
  74.      Joe Veazey: 73227.2656@compuserve.com
  75.                  jveazey@bmc.com
  76.      Thore Boeckelmann: tboeckel@uni-paderborn.de
  77.  
  78.  
  79. HISTORY
  80.      1.0: - first release by Joe Veazey
  81.  
  82.      2.0: - second release by Thore Boeckelmann
  83.           - added support for MapleV R4 worksheets
  84.      2.1: - fixed problems with R4 worksheets from Intel systems
  85.           - added support for missing region markers
  86.           - R4 Hyperlinks (not supported by R3) are now surrounded by "_" and
  87.             treated as comments
  88.  
  89.  
  90. ============================= Archive contents =============================
  91.  
  92. Original  Packed Ratio    Date     Time    Name
  93. -------- ------- ----- --------- --------  -------------
  94.     3584    1540 57.0% 04-Mar-98 16:13:10  ReadWorkSheet.readme
  95.     1406     516 63.3% 04-Mar-98 16:15:36  ReadWorkSheet.readme.info
  96.    44606    7464 83.2% 04-Mar-98 12:41:42  ReadWorkSheet.rexx
  97.      807     586 27.3% 04-Mar-98 16:15:36  ReadWorkSheet.rexx.info
  98. -------- ------- ----- --------- --------
  99.    50403   10106 79.9% 07-Mar-98 19:53:24   4 files
  100.